PATHMac OS 8 Developer Documentation > Files > Navigation Services >

Programming With Navigation Services 1.1

DISCUSSION

Use this function to pre-load the Navigation Services library. Pre-loading increases the memory used by your application, but it provides the best performance when using Navigation Services functions. If you don't use the NavLoad function, the Navigation Services shared library is not loaded until your application calls one of the Navigation Services functions and unloads after the call completes. If you use the NavLoad function, you must call the function NavUnload if you want to release reserved memory prior to quitting.

NavUnload

Unloads the Navigation Services shared library.

OSErr NavUnload (void);

function result

see Result Codes for a list of result codes.

DISCUSSION

This function allows your application to unload the Navigation Services library and release the memory reserved for it. If you use the function NavLoad NavLoad to load the Navigation Services library, you must call the NavUnload function if you want to release reserved memory prior to quitting.

NavGetDefaultDialogOptions

Determines the default attributes or behavior for dialog boxes.

OSErr NavGetDefaultDialogOptions (NavDialogOptions *dialogOptions);

dialogOptions

A pointer to a structure of type NavDialogOptions . On return, Navigation Services fills out the structure with default option values that your application can change as needed.

function result

see Result Codes for a list of result codes.

DISCUSSION

This function gives you a simple way to initialize a structure of type NavDialogOptions and set the default dialog box options before calling one of the dialog box display functions. After you create the NavDialogOptions structure, you can supply it with the NavDialogOptions constants, described in Configuration Option Constants , to change the configuration options.

NavDisposeReply

Releases the memory allocated for a NavReplyRecord structure after your application has finished using the structure.

OSErr NavDisposeReply(NavReplyRecord *reply);

reply

A pointer to a structure of type NavReplyRecord that your application has created.

function result

see Result Codes for a list of result codes.

DISCUSSION

If your application calls a Navigation Services function that uses a structure of type NavReplyRecord , you must use the NavDisposeReply function afterward to release the memory allotted for the NavReplyRecord structure.